home *** CD-ROM | disk | FTP | other *** search
/ The 640 MEG Shareware Studio 2 / The 640 Meg Shareware Studio CD-ROM Volume II (Data Express)(1993).ISO / person / hbrm12.zip / HOME.DOC next >
Text File  |  1992-04-12  |  41KB  |  758 lines

  1.  
  2.  
  3. **************************************************************************
  4. *                        HOME BASIS RECORD MANAGER                       *
  5. *                      Release 1.2        April 1992                     *
  6. **************************************************************************
  7.  
  8.                               Robert Gellman
  9.                              Gellman Software
  10.                           431 Fifth Street, S.E.
  11.                           Washington, D.C. 20003
  12.  
  13.                    (C) Copyright 1991-92  Robert Gellman
  14.                            ALL RIGHTS RESERVED.
  15.  
  16.           ===>  THIS PROGRAM IS SHAREWARE.  DETAILS BELOW.  <===
  17.  
  18.      If you own a house, condominium, cooperative, house trailer, or any
  19. type of residence, you need HOME BASIS RECORD MANAGER.  This program will
  20. help you keep track of the basis (or cost) of your home.  This information
  21. is vital when you sell your home.  By using the HOME BASIS RECORD MANAGER,
  22. you can be certain that you will have all the information necessary to
  23. minimize the taxes due on the profits from the sale of your home.
  24.  
  25.      The tax laws allow a homeowner who sells one home and buys another to
  26. rollover any taxes due.  This means that taxes on profits from the sale of
  27. a home can be postponed for many years.  This also means that you have to
  28. maintain information about a home for years or decades after you have sold
  29. it.  HOME BASIS RECORD MANAGER is perfectly designed for this purpose.
  30.  
  31.      Listen to the IRS:  "You should save receipts and other records for
  32. all improvements, additions, and other items that affect the basis of your
  33. home.  Ordinarily, you must keep records for 3 years after the due date for
  34. filing your return for the tax year in which you sold, or otherwise
  35. disposed of, your home.  But if you use the basis of your old home in
  36. figuring the basis of your new one, such as when you sell your old home and
  37. postpone tax on any gain, YOU SHOULD KEEP THOSE RECORDS AS LONG AS THEY ARE
  38. NEEDED FOR TAX PURPOSES."
  39.  
  40.      Why do you need a computer program to accomplish this?  You could
  41. maintain the information in a ledger.  But you won't.  This program will
  42. prompt you to maintain complete, up-to-date records.  It has information
  43. about basis that you don't have.  It provides printed reports.  If you are
  44. like most computer users who have read this far, you know that you are more
  45. likely to keep complete records in a computer than on paper.
  46.  
  47.      HOME BASIS RECORD MANAGER will help you to identify all costs
  48. associated with home ownership.  The purchase price of your home is just
  49. the starting point.  The program lists three dozen circumstances that can
  50. affect the basis of your home.  Scanning the list provided by the program
  51. will help you to identify every cost element.  The discipline of the
  52. program will save you money.
  53.  
  54.      Tax laws are complex, and there are many surprising events that change
  55. the basis for home ownership.  HOME BASIS RECORD MANAGER offers no tax
  56. advice.  It just helps you in maintaining the records that are necessary so
  57. that you can minimize your taxes.  You may need to consult with a tax
  58. advisor before actually paying tax on the sale of your home, but with
  59. complete records you can be assured of paying the minimum tax possible.  
  60.  
  61. **************************************************************************
  62. *                          RUNNING THE PROGRAM                           *
  63. **************************************************************************
  64.  
  65.      To start HOME BASIS RECORD MANAGER, change to the directory or drive
  66. containing HOME.EXE and enter HOME at the DOS prompt.  The program requires
  67. 256 K and should run under DOS 2.0 or better.  Both color and monochrome
  68. monitors are supported.  A graphics card is not required.
  69.  
  70.      HOME BASIS RECORD MANAGER is menu-driven and simple to use.  If you
  71. managed to buy a house, then you can operate the program.   The best way to
  72. learn is to use the program for a while.  Enter a new house and a few
  73. events.  Then come back and read this file.  This documentation explains
  74. the finer points.
  75.  
  76.      There are three command line switches.  One switch (/HP) selects the
  77. HP Laserjet as the default printer.  Another switch (/IBM) selects the IBM
  78. Proprinter (dot matrix) as the default printer.  Printer use is explained
  79. more fully below.  The third switch allows you to override the use of color
  80. on a color monitor.  To suppress color, use the /BW switch.  You may use
  81. both switches if you like.  Start the program this way:  HOME/BW/HP.
  82.  
  83.  
  84.  
  85. **************************************************************************
  86. *                             REGISTRATION                               *
  87. **************************************************************************
  88.  
  89.      HOME BASIS RECORD MANAGER is shareware.  Shareware provides you with
  90. an opportunity to try a program before you are obliged to pay for it.  You
  91. may use the program on a trial basis for 30 days.  If you don't like it and
  92. don't use it, you own nothing.  If you use the program thereafter, you are
  93. obliged to register with the author.  The price is $25.00.  If you can
  94. afford to buy a home, then you can afford to pay for this software.
  95.  
  96.      To register the program, send $25.00 with your name, address, the
  97. version number you are using, and where you acquired the program, to:
  98.  
  99.                              Robert Gellman
  100.                          431 Fifth Street, S.E.
  101.                           Washington, DC 20003
  102.  
  103.      I hate documentation that goes on for pages explaining shareware and
  104. begging for registrations, so this is it.  IF YOU USE THE PROGRAM, PLEASE
  105. PAY FOR IT.  There are more details on the license agreement, disclaimer of
  106. warranty, and other legal technicalities later in this documentation.  
  107.  
  108.      ===> DISCOUNT <===  Gellman Software also offers STOCK PORTFOLIO
  109. RECORD MANAGER, an easy-to-use program that maintains all of the records
  110. needed to manage investments in the stock market.  Registered users of the
  111. STOCK PORTFOLIO RECORD MANAGER can register HOME BASIS RECORD MANAGER for
  112. $20.00.  Registered users of HOME BASIS RECORD MANAGER are also entitled to
  113. a $5.00 discount on the $25 price of the stock market program.  Registered
  114. users of either program also may obtain copies of five freeware game
  115. program from Gellman Software.  See appendix 1 for more information.
  116.  
  117.      Thanks for your interest and cooperation.  
  118.  
  119. **************************************************************************
  120. *                             DOCUMENTATION                              *
  121. **************************************************************************
  122.  
  123.      This document explains the program's general approach and includes
  124. lots of explanatory information.  This document file has margins at 5 and
  125. 75, and there are form feeds roughly every 60 lines.  If you want to print
  126. the document, you can enter TYPE HOME.DOC > PRN from the DOS prompt.  Or
  127. you can load it in your word processor with the proper margins and edit it
  128. to meet your needs.
  129.  
  130.      The program is not as valuable if you can't print reports.  You must
  131. have an IBM Proprinter, HP Laserjet, or printer that is compatible with
  132. either.  Most dot matrix printers work like the IBM, and most laser
  133. printers can emulate the HP.  You must use continuous form paper in your
  134. dot matrix printer.  Version 1.2 permits printing to a DOS file.   The
  135. printer selection process is explained later.  
  136.  
  137.      
  138. **************************************************************************
  139. *                          ADVICE FOR NEW USERS                          *
  140. **************************************************************************
  141.  
  142.      When you start HOME BASIS RECORD MANAGER for the first time, you are
  143. told that the main data file (HOME.DAT) cannot be found.  This is a warning
  144. in the event that any existing data files are not in the current directory. 
  145. Ignore the warning the first time you see it.  If you see it after you have
  146. entered data, chances are that you are in the wrong directory or a file is
  147. missing.  Investigate before entering more data.
  148.  
  149.      When you get to the main menu on your first visit, you only have two
  150. live options.  You can ENTER A NEW HOUSE from the ENTER menu.  The other
  151. option is to QUIT the program.  Once you have entered a new house, all
  152. other options are available.  
  153.  
  154.      The program is easy to use once you get started.  Define a new house,
  155. and then add events to it.  Start with your settlement sheet and find every
  156. expense that affects your basis.  In my case, I found 15 basis events
  157. connected with the purchase of my house.  These included inspections, title
  158. searches, title insurance, and attorney.  You may have more events or
  159. fewer.  Everyone's experience is different.
  160.  
  161.      I have also recorded about 15 improvements that I have made in the ten
  162. years I have owned my house.  Some were major -- like a new heating system
  163. or a new room.  Others were minor -- like a door knocker.  Refinancing my
  164. mortgage added ten more events.  You can list separately all expenses
  165. related to a specific improvement or you can lump them together.  This is
  166. entirely up to you.
  167.  
  168.  
  169.  
  170.  
  171. **************************************************************************
  172. *                             WHAT IS BASIS?                             *
  173. **************************************************************************
  174.  
  175.      NOTE:  Most of the information in this section is taken from IRS
  176. publications.  Tax laws are changeable, and there is NO guarantee that this
  177. information is either correct or current.  
  178.  
  179.      Basis is a way of measuring your investment in property for tax
  180. purposes.  The basis of property you buy is usually the cost or purchase
  181. price.  While you own the property, you may make adjustments (increases or
  182. decreases) to the basis.  If you change the original basis, you have
  183. adjusted the basis.
  184.  
  185.      This adjusted basis is used to figure gain or loss when you sell or
  186. otherwise dispose of the property.  You also must know the adjusted basis
  187. at the time of a casualty to determine your deductible loss for the
  188. casualty.  If you change your home to rental or business use, your
  189. depreciation is based on the fair market value of the home or its adjusted
  190. basis at the time of the change, whichever is less. 
  191.  
  192.      PURCHASE - The original basis of a home you bought is the purchase
  193. price or cost of the property to you.  This includes your down payment and
  194. notes you gave to the seller.  Certain settlement or closing costs are
  195. added to or deducted from your basis.  Some of these costs are discussed
  196. below.
  197.      
  198.      CONSTRUCTION - If you contracted to have your house built on land you
  199. own, your original basis is the cost of the land plus the amount it cost
  200. you to complete the house.  This includes the cost of labor and materials,
  201. or the amounts paid to the contractor, and any architect's fees, building
  202. permit charges, utility meter and connection charges, and legal fees
  203. directly connected with building your home.
  204.  
  205.      If you built all or part of your house yourself, the original basis is
  206. the total amount it cost you to complete it.  Do not include the value of
  207. your own labor or any other labor you did not pay for in the cost of the
  208. house.
  209.  
  210.      CONDOMINIUM - Your basis is its cost plus improvements.
  211.  
  212.      COOPERATIVE APARTMENT - Your basis in the apartment is usually the
  213. cost of your stock in the co-op housing corporation, which may include your
  214. share of a mortgage on the apartment building.
  215.  
  216.      GIFT - If your home was a gift, its original basis to you is the same
  217. as the donor's adjusted basis when the gift was made.  However, if the
  218. donor's adjusted basis was more than the fair market value of the home when
  219. it was given to you, you must use that fair market value as your basis for
  220. measuring any possible loss if you later sell the home.  You still use the
  221. donor's adjusted basis to measure any gain.  Please be aware that gifts
  222. raise complicated tax questions.  Consult the IRS or your tax advisor.
  223.  
  224.  
  225.  
  226.      INHERITANCE - If you inherited your home, the original basis of the
  227. home is its fair market value on the date of the decedent's death or the
  228. later alternate valuation date if that date was used for federal estate tax
  229. purposes.  If you are a surviving spouse, and you owned your home jointly,
  230. your basis for the half interest owned by your spouse will be one-half of
  231. the fair market value on the date of death (or alternate valuation date). 
  232. The basis in your half will remain one-half of the adjusted basis
  233. determined previously.  Your new basis is the total of these two amounts.
  234.  
  235.      ADJUSTED BASIS - This is your original basis increased or decreased by
  236. certain amounts.
  237.  
  238.      Increases to basis include:  1) Improvements;  2) Additions;  3) Other
  239. capital expenses;  4) Special assessments for local improvements;
  240. 5) Amounts spent to restore damaged property;  6)  Legal recording fees; 
  241. 7) Abstract fees;  8) Surveys;  9) Transfer taxes;  10) Title insurance;  
  242. 11) Architect's fees.  This is not a complete list.
  243.  
  244.      Decreases to basis include:  1) Insurance reimbursement for casualty
  245. losses;  2) Deductible casualty loss not covered by insurance;  3) Payment
  246. received for easement or right-of-way granted;  4) Depreciation deduction
  247. if you used your home for business or rental purposes;  5) Gain from sale
  248. of old home on which tax was postponed.  This is not a complete list.
  249.  
  250.      Certain settlement fees do not affect basis at all:  1) Points; 
  251. 2) Fire insurance premiums;  3) Mortgage insurance premiums;  4) Charges
  252. for services concerning occupancy of the house.
  253.  
  254.      An improvement adds to the value of your home, prolongs its useful
  255. life, or adapts it to new uses.  Improvements are added to the basis of
  256. your property.  Improvements can be anything from a new room to a new
  257. furnace to built-in furnishing to new appliances to new locks.
  258.  
  259.      Repairs maintain your home in good condition.  They do not add to the
  260. value or prolong its life and are not added to the basis of your property.
  261.  
  262.      For example, putting a recreation room in your unfinished basement,
  263. adding a bathroom, putting up a fence, putting on a new roof, and paving
  264. your driveway are IMPROVEMENTS.  These are added to basis.
  265.  
  266.      Repainting your house, fixing gutters, repairing leaks, and replacing
  267. broken windows are REPAIRS.  These expenses do not affect your basis.  But
  268. if items that are considered repairs are done as part of extensive
  269. remodeling or restoration, the entire job is considered an improvement.
  270.  
  271.      If you claimed any residential energy credit and added the cost of
  272. energy items considered improvements to the basis of your home, you also
  273. must decrease the basis by the amount you claimed as a credit.
  274.  
  275.      
  276.  
  277.  
  278.  
  279. **************************************************************************
  280. *                          BASIS CATEGORIES                              *
  281. ************************************************************************** 
  282.  
  283.     HOME BASIS RECORD MANAGER recognizes over 40 basis categories.  Most of
  284. these categories represent events that increase basis.  Some represent
  285. events that decrease basis.  A few represent events that do not affect
  286. basis at all.
  287.  
  288.      The categories are used to keep similar events together.  One report
  289. lists all events for a house according to the basis categories.  Thus, all
  290. improvements will be listed together.
  291.  
  292.      You are not required to use the categories provided by the program. 
  293. While the list of categories is long, it may not include every category of
  294. basis that affects real estate.   You may supply your own categories if you
  295. like.  Follow the prompt (i.e., just hit ESCAPE) from the basis category
  296. screen.
  297.  
  298.      The list of categories will prompt you to identify and include all
  299. events that affect basis.  Scan through the list when it appears on the
  300. screen to look for basis events you might have missed.  
  301.  
  302.      The list of categories shows whether events in that category normally
  303. increase or decrease basis.  This is just a guide.  An unusual transaction
  304. may result in a different effect.  If so, don't feel bound by the guidance. 
  305. Do the right thing.
  306.  
  307.      You can enter events that have no effect on basis.  This is a helpful
  308. facility for several reasons.  First, you can track other events related to
  309. your house that are not basis events.  For example, you might want to know
  310. how much you have spent on repairs that do not affect basis.
  311.  
  312.      Second, you may not be sure if or how some events affect basis.  For
  313. example, points paid by the buyer are normally not basis events, but they
  314. may be in some circumstances.  If you are not sure, record the points as an
  315. event that does not affect basis.  You will have all of the relevant
  316. information, and you can decide on the tax consequences later.  
  317.  
  318.      For more information about basis, I recommend IRS publications 523
  319. (Tax Information on Selling Your Home) and 551 (Basis of Assets).  These
  320. are available at no cost from the IRS.  
  321.  
  322.      For each event, the program allows for both a description and a basis
  323. category.  The purpose of the description is to identify the specific
  324. event.  For example, all new rooms added to your house will be categorized
  325. as "improvements".  You use the description so that you can distinguish
  326. between the new bedroom and the new porch.  
  327.  
  328.      You also may use the note fields that are part of each event to
  329. include additional details of each transaction.  There are two notes
  330. fields.  Use them or leave them blank as you please.
  331.  
  332.  
  333.  
  334.  
  335. **************************************************************************
  336. *                        HOW THE PROGRAM WORKS                           *
  337. **************************************************************************
  338.  
  339.      You will find it helpful to understand how the program stores
  340. information.  There are two types of files created and maintained by the
  341. program.  Summary information about all houses is maintained in a file
  342. called HOME.DAT.  This file grows in size with each house entered.
  343.  
  344.      For each house, you must provide an eight character DOS file name for
  345. that house.  Information about the events entered for each house is
  346. maintained in a file using that name with a .LOG extension.  There is one
  347. .LOG file for each house.  
  348.  
  349.      The program checks to make sure that a house file name does not create
  350. a DOS file with a reserved file name.  Thus, names like CON, NUL, LPT1,
  351. LPT2, COM1, COM2, COM3, COM4, LST, and AUX will be rejected.  These are
  352. reserved names in some versions of DOS.  If your file name is rejected,
  353. just pick another one.  
  354.  
  355.      The .LOG file contains information about each basis event entered. 
  356. The file grows in size with each event entered.
  357.  
  358.      If you enter two houses, there will be three data files on your disk
  359. (HOME.DAT plus two .LOG files).  You may NOT change the name of these
  360. files.  If you delete any of these files through DOS rather than through
  361. the menu, all of your data will be irretrievably ruined.  The program
  362. cannot deal with missing files or renamed files.  You may, however, rename
  363. the HOME.EXE file.
  364.  
  365.  
  366. **************************************************************************
  367. *                               PRINTERS                                 *
  368. **************************************************************************
  369.  
  370.      While all information can be viewed on the screen, some useful reports
  371. can only be printed.  The reports are the most powerful feature of the
  372. program.  You no longer need a printer to see reports.  Beginning with
  373. version 1.2, you can print reports to a DOS file, and printing to a DOS
  374. file is the default.  See the PRINT TO FILE discussion below.
  375.  
  376.      The program supports two physical printers:  the IBM Proprinter and
  377. the HP Laserjet.  There are two ways to select a physical printer.  First,
  378. pick SELECT PRINTERS (option 4) from the PRINT menu.  Follow the prompts to
  379. make a selection.  You can switch printers during a session as often as you
  380. like.  The SELECT PRINTERS menu line shows which printer type is the
  381. current selection.  
  382.  
  383.      Second, there is a command line switch to specify a physical printer. 
  384. This switch allows you to specify a printer in a batch file without having
  385. to remember to select it each time you run the program.  To select the HP
  386. Laserjet, enter HOME/HP from the DOS prompt.  Enter HOME/IBM to select the
  387. IBM Proprinter.
  388.  
  389.  
  390.  
  391.      If you don't have a Proprinter or Laserjet, you still may be able to
  392. print.  Most laser printers emulate the HP codes.  If your printer can use
  393. HP codes, then you can print reports.  Many dot matrix printers use the
  394. same codes as the IBM Proprinter.  If you have any dot matrix printer, try
  395. the IBM selection.  When using any dot matrix printer, you must use
  396. continuous form paper.  You cannot feed single sheets.
  397.  
  398.      There are only three printer codes used by the program so there is a
  399. good chance that your printer is compatible.  The IBM Proprinter codes used
  400. are CHR$(12) [Form Feed]; CHR$(15) [Condensed Printing - approximately 17 
  401. characters per inch]; and CHR$(18) [Regular Printing - 10 characters per 
  402. inch].  You cannot control the printer using printer switches because most 
  403. reports use both regular and condensed printing.
  404.  
  405.      All physical printing is done through LPT1.  If your printer is
  406. connected to another parallel port or to a serial port, you must handle
  407. printer redirection at the DOS level.  If you don't understand this
  408. paragraph, don't worry about it unless you can't print.  Then you should
  409. consult your DOS manual about use of the MODE command.
  410.  
  411.      When you order a printed report, the program tests to see if printer 1
  412. (LPT1) is on-line.  If it isn't, you are warned.  This test is not reliable
  413. for every type of equipment and configuration so an override is provided. 
  414. If you try to print and there is no printer, the program will crash.  VERY
  415. IMPORTANT:  Before you do this for the first time, exit back to DOS.  This
  416. writes any data you entered to the disk.  Then if the program crashes, you
  417. won't lose any data entered during the current session.
  418.  
  419.  
  420. **************************************************************************
  421. *                                REPORTS                                 *
  422. **************************************************************************
  423.  
  424.      HOME BASIS RECORD MANAGER provides several printed and visual reports. 
  425. The reports are the most powerful feature of the program.  All information
  426. maintained by the program can be printed.  
  427.  
  428.      The report menu offers three types of printed reports.  The first is a
  429. list of all events associated with a house organized by basis categories. 
  430. This is likely to be the most useful report.  
  431.  
  432.      The second report is a list of all events for a house organized by
  433. basis effect.  All increases are listed together; all decreases are listed
  434. next; events with no effect are last.
  435.  
  436.      The third report is a summary of all houses.  There is one line
  437. listing for each house contains a description of the house, the date of the
  438. first and last event for that house, and the current basis of the house.  
  439.  
  440.      In addition to the formal reports, you can print a complete list of
  441. each house and its events.  You may print the entire file or, the main
  442. house files alone.  The screen prompt explains the available options.
  443.  
  444.  
  445.  
  446. **************************************************************************
  447. *                           ASSORTED DETAILS                             *
  448. **************************************************************************
  449.  
  450.      1) CURRENT DIRECTORY:  The program looks for and creates its data
  451. files in the current directory.  Any marginally adept PC user should
  452. already understand directories.  If you don't, read the DOS manual.
  453.  
  454.      HOME BASIS RECORD MANAGER can be run from a floppy or hard disk.  The
  455. data files MUST be in the current directory when the program is started. 
  456. The program can be kept elsewhere if you understand how to do it.  
  457.  
  458.      2) DATA ENTRY:  You can enter and correct new data for a house or
  459. event before formally adding it to the program.  Enter data in the
  460. highlighted field and move to the next field by hitting ENTER or by using
  461. the UP or DOWN cursor keys.  If you try to move in an impermissible
  462. direction, nothing happens.  When the input is correct, highlight the "ALL
  463. DONE" box and hit ENTER.  The ESCAPE key aborts the current data entry.
  464.  
  465.      While entering or editing data in a highlighted field, the standard
  466. editing keys work.  This includes the cursor keys, HOME, END, BACKSPACE,
  467. DELETE.  The INSERT key toggles the standard insert mode.  If you enter
  468. more characters in a data field than the program can accept, the program
  469. beeps at you.  
  470.  
  471.      Some data fields are optional.  These fields can be used to hold any
  472. information that you like.  If data is mandatory and you fail to provide
  473. it, you will not be able to continue.  There are separate note fields for
  474. each house and each event.
  475.  
  476.      3) DELETE RECORDS:  You can delete an individual event or an entire
  477. house file through the delete menu.  If you delete a house file, all
  478. associated events are also deleted.  You are warned several times before
  479. files are actually deleted.
  480.  
  481.      The only safe way to delete files is through the program.  If you
  482. delete an event (.LOG) file through DOS, the house file will still be in
  483. HOME.DAT.  Serious problems will arise because there are no underlying
  484. events.  The program cannot recover from a missing .LOG file.  The only
  485. hope is to delete the house entry and start again.
  486.  
  487.      4) CHANGE RECORDS:  Any data that can be entered by the user can be
  488. changed through the change menu.  House and event data can be modified.
  489.  
  490.      5) DOLLAR LIMITS:   HOME BASIS RECORD MANAGER can handle transactions
  491. in the millions of dollars.  
  492.  
  493.      6) BACKUPS - I STRONGLY recommend that you back up all data in several
  494. ways.  I keep multiple copies of my data files in case of disaster.  I keep
  495. printed copies of data as well.  Finally, I keep all original documents so
  496. that I can recreate the data files if necessary.  UNDER NO CIRCUMSTANCES
  497. should you rely exclusively on the program as the only source of data. 
  498. There is a possibility that an undiscovered error will ruin all data. 
  499. Always be able to recreate essential records.  The legal gobbledygook below
  500. disclaims all responsibility for program failures.
  501.  
  502.  
  503.      7) PRINT TO FILE - Version 1.2 added the ability to print reports to a
  504. DOS file.  This saves paper, allows those with nonconforming printers to
  505. use the program, and permits users to import reports into other programs. 
  506. Printing to a DOS file is the default.  To print on paper, use the SELECT
  507. PRINTERS option on the PRINT menu or the command line switches.  
  508.  
  509.      The program will examine the path and file name that you enter, and
  510. blatantly illegal choices will be rejected.  All target file names MUST
  511. have a .RPT extension, and the default file name is HOUSE.RPT.  Remember
  512. that the path and file name are only checked for validity and not for
  513. availability.  If the drive you select is full or not available (e.g., the
  514. drive door is open), the program will crash.
  515.  
  516.      If the program does crash, any data entered during the current session
  517. may be lost and data files can be ruined.  To be extra careful before
  518. printing to a disk file, exit the program first to write all new data to
  519. disk.  Then restart the program and print to your disk file.
  520.  
  521.      Data written to a disk file will be appended to a file.  This permits
  522. you to write multiple reports from the one or more sessions to the same
  523. disk file.  You can change the name of the target DOS file as often as you
  524. like during a session.
  525.  
  526.      I use Vern Buerg's LIST program to read reports written to a disk
  527. file.  LIST can be found on any computer bulletin board or shareware
  528. library.  Other file viewers and word processing programs will work too.
  529.  
  530.  
  531.  
  532. **************************************************************************
  533. *                          PROBLEMS, PROBLEMS                            *
  534. **************************************************************************
  535.  
  536.      I have made only limited attempts to make HOME BASIS RECORD MANAGER
  537. idiot-proof.  If you want to screw up the data, you can do it.  Things will
  538. go well if you follow instructions and enter good data.
  539.  
  540.      Your data should be safe unless you take steps to erase it.  Data is
  541. vulnerable right after it is entered.  The program does not always write
  542. new data to disk immediately.  The best precaution after entering new data
  543. is to exit the program.  This flushes the buffers and writes data to disk.
  544. If you find that data in a house file becomes irretrievably incorrect, you
  545. may have to delete the file for that house and start over.  
  546.  
  547.      Any abnormal end to the program can result in the loss of newly
  548. entered data.  ALWAYS exit through the menu.  An abnormal termination may
  549. also result in the retention of temporary working files.  If you find files
  550. in the default directory with a .XXX extension, these files can (and
  551. should) be deleted.
  552.  
  553.      If HOME BASIS RECORD MANAGER can't find the HOME.DAT data file when it
  554. starts, you are warned.  When you run the program for the first time, this
  555. warning should be ignored.  If you see this warning at any other time,
  556. check it out before you enter any new data.  Note that a missing .LOG file
  557. produces no warning.  You are responsible for maintaining the existence and
  558. integrity of the data files except when the program is running.  The
  559. program has not been known to trash its own files.
  560.  
  561.      The program has been tested in a reasonably thorough manner.  Of
  562. course, it is likely that there are still a few bugs somewhere, and new
  563. features may create new difficulties.  Please write to me if you encounter
  564. a problem or any difficulty of any type.  Be specific about the problem and
  565. what you did that resulted in the error.  
  566.  
  567.  
  568. **************************************************************************
  569. *                     PROGRAMMING NOTES AND HISTORY                      *
  570. **************************************************************************
  571.  
  572.      The current version is written and compiled in Microsoft's QuickBASIC
  573. 4.5 under DOS 3.1.  The source code is not public.  The program uses the
  574. PROBAS Professional BASIC Programming Library.  PROBAS is a product of
  575. Hammerly Computer Services of Laurel, Maryland.
  576.  
  577.      Version 1.2 was released in April 1992.  Changes and improvements
  578. include:
  579.  
  580.           -- Revision of introductory, closing, and other screens and
  581.      messages.
  582.  
  583.           -- Addition of the capability of printing to a DOS file. 
  584.      Printing to DOS is the default, and a new command line switch has been
  585.      added to select the IBM Proprinter.
  586.  
  587.           -- The program now recognizes February 29 as a legal date, but it
  588.      does not check to see if it is a leap year.
  589.  
  590.           -- The report by basis category has been modified slightly so
  591.      that a category subheading will not print alone at the bottom of a
  592.      page.
  593.  
  594.  
  595.      Version 1.1 was the first public version.  It was released in July
  596. 1991.
  597.  
  598.  
  599. ***************************************************************************
  600. *            LICENSE AGREEMENT AND OTHER LEGAL STUFF                      *
  601. ***************************************************************************
  602.  
  603.      THIS PROGRAM AND ACCOMPANYING DOCUMENTATION ARE PROVIDED "AS IS" AND
  604. WITHOUT WARRANTY OF ANY KIND.  THE ENTIRE RISK AS TO THE RESULTS AND
  605. PERFORMANCE OF THE PROGRAM IS ASSUMED BY THE USER.  The entire liability of
  606. Gellman Software and Robert Gellman shall be limited to a return of the
  607. registration price or replacement of the program at the option of Gellman
  608. Software and Robert Gellman.
  609.  
  610.      GELLMAN SOFTWARE AND ROBERT GELLMAN DISCLAIM ALL WARRANTIES, EITHER
  611. EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO IMPLIED WARRANTIES OF
  612. MERCHANTABILITY OR FITNESS FOR A PARTICULAR PURPOSE WITH RESPECT TO THE
  613. PROGRAM AND WRITTEN MATERIALS.  
  614.  
  615.      IN NO EVENT SHALL GELLMAN SOFTWARE OR ROBERT GELLMAN BE LIABLE FOR ANY
  616. DAMAGES WHATSOEVER (INCLUDING WITHOUT LIMITATION DAMAGES FOR LOSS OF
  617. BUSINESS PROFITS, BUSINESS INTERRUPTION, LOSS OF BUSINESS INFORMATION,
  618. SPECIAL, INCIDENTAL, CONSEQUENTIAL, INDIRECT, OR SIMILAR DAMAGES) DUE TO
  619. LOSS OF DATA OR ARISING OUT OF THE USE OF OR INABILITY TO USE THIS PROGRAM
  620. EVEN IF GELLMAN SOFTWARE OR ROBERT GELLMAN HAS BEEN ADVISED OF THE
  621. POSSIBILITY OF SUCH DAMAGES.
  622.  
  623.      Anyone may use the program for a thirty day trial period.  At the
  624. conclusion of the trial period, you must stop using the program or pay a
  625. $25.00 registration fee.  To register, send $25.00 with your name, address,
  626. and version number you are using to:
  627.  
  628.                              Robert Gellman
  629.                          431 Fifth Street, S.E.
  630.                           Washington, DC 20003
  631.  
  632.      I will respond to all who register to let you know if you are using
  633. the latest version.  Copies of later versions will only be provided in
  634. accordance with the update policies set out below.
  635.  
  636.      There is no restriction on personal use of the program by a registered
  637. user.  Registered users may not license others to use the program or
  638. transfer their license to others.
  639.  
  640.      Anyone may give a copy of the program with all accompanying
  641. documentation to any other person.  The program with its documentation may
  642. be distributed by computer bulletin boards, software clubs, shareware
  643. libraries, and similar organizations at a standard charge for media and
  644. distribution.  The maximum charge permitted without specific written
  645. permission from Gellman Software is $6.00.  No other forms of distribution
  646. for money are authorized.
  647.  
  648.      The program and its documentation are copyrighted.  No one is
  649. authorized to make changes to either the program or the documentation.
  650.  
  651.  
  652.  
  653. ***************************************************************************
  654. *                             UPDATE POLICIES                             *
  655. ***************************************************************************
  656.  
  657.      I plan to fix errors, make changes and improvements, and add new
  658. features from time to time.  I WELCOME SUGGESTIONS FROM USERS.  I am not,
  659. however, making any binding commitments to issue updates or corrections.  
  660.  
  661.      While I expect to issue occasional updates, I am not anxious to get
  662. into the disk distribution business.  HOME BASIS RECORD MANAGER is
  663. available from the Public (Software) Library, P.O. Box 35705, Houston, TX
  664. 77235.  I provide updates to PSL as soon as they are released.  At this
  665. time, disks are available from PSL for $5.00 plus a $4.00 shipping charge. 
  666. A 3.5 inch disk costs an extra dollar.  I encourage everyone to use PSL. 
  667. It offers good service, and its monthly shareware catalog is excellent.  
  668.  
  669.      Second, if you have a modem, you can download the programs from an
  670. Alexandria, Virginia, computer bulletin board called CHELSEA SYSTEMS.  My
  671. programs can be found there under the name SPRMxx.ZIP and HBRMxx.ZIP.  The
  672. xx in the name is the current version number.  The number of CHELSEA
  673. SYSTEMS is 703-922-4077.  Sysop Donald Rosenberger allows first time
  674. callers to download files.  If you invest in the stock market, you may also
  675. be interested Rosenberger's Security Analyst (SA300.ZIP).  Security Analyst
  676. performs fundamental analysis by calculating over 30 ratios such as P/E,
  677. Debt to Equity, and Book Value.  Another useful Rosenberger program is
  678. SCHWB242.ZIP, which calculates commissions for transactions with Charles
  679. Schwab & Co.
  680.  
  681.      I try to put new versions on Compuserve and GEnie, although I am not
  682. on either system as a user.  
  683.  
  684.      Finally, I will make updates directly available to registered users in
  685. two ways.  Any registered user who sends me a self-addressed, stamped disk
  686. mailer and a disk can receive a copy of the latest version at no cost.  If
  687. a user wants me to provide the disk and mailer, the cost is $10.00 ($12.00
  688. for 3.5 inch disks).  I reserve the right to revoke this offer at any time.
  689.  
  690.      I really want to discourage people from asking me to provide disks and
  691. mailers.  That's the reason for the high price.  I don't have the time or
  692. the facilities.  But I want to accommodate my users, and I will provide
  693. updates at no cost if you provide the disk, the mailer, and the postage.
  694.  
  695.      If you like, I can include my other programs along with any update.  
  696. If you like the home basis program and you own stocks, please consider my
  697. STOCK PORTFOLIO RECORD MANAGER.  My other programs are freeware games and
  698. are described in Appendix I.  Let me know if there are any that especially
  699. appeal to you.  Tell me if you can handle ZIP archives and I will send
  700. everything squeezed on one disk.  All of my programs will not fit on a
  701. single 360K floppy.  It takes two regular floppies or one 1.2 Meg floppy. 
  702. HBRM and the stock market program will fit on one disk, however.
  703.  
  704.      I will try to respond to any correspondence from registered users so
  705. let me know if you need help, find problems, or have complaints.  Alas, I
  706. cannot promise to notify registered users of new versions.  The Public
  707. (Software) Library monthly catalog will contain update notices.
  708.  
  709.  
  710. ***************************************************************************
  711. *               APPENDIX I:  OTHER GELLMAN SOFTWARE PROGRAMS              *
  712. ***************************************************************************
  713.  
  714.      SPRM35     STOCK PORTFOLIO RECORD MANAGER         (shareware)
  715.  
  716.           This program stores, manipulates, and prints records needed to
  717.      manage a portfolio of stocks.  STOCK PORTFOLIO RECORD MANAGER totally
  718.      replaces or supplements paper records.  It provides powerful reports
  719.      about your portfolio, transactions, and dividends.  Both laser and dot
  720.      matrix printers are supported.  Anyone who has investments in the
  721.      stock or bond markets should consider using this program.
  722.  
  723.  
  724.      HBRM12     HOME BASIS RECORD MANAGER              (shareware)
  725.  
  726.           If you own a house, condominium, cooperative, house trailer, or
  727.      any type of residence, you need HOME BASIS RECORD MANAGER.  This
  728.      program will help you keep track of the basis (or cost) of your home. 
  729.      This information is vital when you sell your home.  By using the HOME
  730.      BASIS RECORD MANAGER, you can be certain that you will have all the
  731.      information necessary to minimize the taxes due on the profits from
  732.      the sale of your home. 
  733.  
  734.      Gellman Software has also published these freeware games:
  735.  
  736.      POKER567       Head to Head Draw Poker            (freeware)
  737.      1POKER14       Poker Solitaire                    (freeware)
  738.      CALC15         Calculation Solitaire              (freeware)
  739.      LABELLE4       La Belle Lucie Solitaire           (public domain)
  740.      SIXLTR41       Six Letter Word Game               (freeware)
  741.  
  742. The last two programs were coauthored by other programmers.
  743.  
  744.       These programs are available from the Public Software Library, P.O.
  745. Box 35705, Houston, TX 77235.  The latest versions are normally sent to PSL
  746. as soon as they are released.  I recommend PSL to anyone interested in
  747. shareware or freeware.   Gellman Software programs are also available on
  748. finer computer bulletin boards in the Washington, DC area and elsewhere.  
  749.      Copies of all programs are available directly from Gellman Software. 
  750. Send a self-addressed, stamped mailer and disk to the address on the first
  751. page.  State which programs you want.  IMPORTANT:  Please indicate if you
  752. know how to handle ZIP archives.  If you want all programs, send one 1.2
  753. Meg disk, two 360K disks if you can unZIP, or three 360K disks if you do
  754. not understand ZIP archives.  There is no charge if you supply the disk,
  755. the mailer, and the postage.  
  756.  
  757.  
  758.                         ****End of HOME.DOC****